Developer Documentation

QuickTime 4 API Documentation

3D Graphics Programming with QuickDraw 3D 1.5.4

Previous | QD3D Book | Overview | Chapter Contents | Next |

Managing Picking Parts Styles

QuickDraw 3D provides routines that you can use to manage picking parts styles.

Q3PickPartsStyle_New

You can use the Q3PickPartsStyle_New function to create a new picking parts style object.

TQ3StyleObject Q3PickPartsStyle_New (TQ3PickParts parts);
parts
A picking parts style value.

DESCRIPTION

The Q3PickPartsStyle_New function returns, as its function result, a new style object having the picking parts style specified by the parts parameter. See "Picking Parts Styles" for a list of masks you can use to construct a picking parts style value.

If a new style object could not be created, Q3PickPartsStyle_New returns the value NULL .

To change the current picking parts style, you must actually draw the style object. You can call Q3Style_Submit to draw the style in retained mode or Q3PickPartsStyle_Submit (described next) to draw the style in immediate mode.

SEE ALSO

See "Picking Parts Styles" for a description of picking parts styles.

Q3PickPartsStyle_Submit

You can use the Q3PickPartsStyle_Submit function to submit a picking parts style in immediate mode.

TQ3Status Q3PickPartsStyle_Submit (
                     TQ3PickParts parts,
                     TQ3ViewObject view);
parts
A picking parts style value.
view
A view.

DESCRIPTION

The Q3PickPartsStyle_Submit function sets the picking parts style of the view specified by the view parameter to the style specified by the parts parameter.

SPECIAL CONSIDERATIONS

You should call Q3PickPartsStyle_Submit only in a submitting loop.

Q3PickPartsStyle_Get

You can use the Q3PickPartsStyle_Get function to get the picking parts style value of a picking parts style.

TQ3Status Q3PickPartsStyle_Get (
                     TQ3StyleObject pickPartsObject,
                     TQ3PickParts *parts);
pickPartsObject
A picking parts style object.
parts
On entry, a pointer to a variable of type TQ3PickParts . On exit, the current picking parts style value of the specified style object.

DESCRIPTION

The Q3PickPartsStyle_Get function returns, in the parts parameter, a pointer to the current picking parts value of the style object specified by the pickPartsObject parameter. See "Picking Parts Styles" for a list of masks used to construct a picking parts value.

Q3PickPartsStyle_Set

You can use the Q3PickPartsStyle_Set function to set the picking parts style value of a picking parts style.

TQ3Status Q3PickPartsStyle_Set (
                     TQ3StyleObject pickPartsObject,
                     TQ3PickParts parts);
pickPartsObject
A picking parts style object.
parts
A picking parts style value.

DESCRIPTION

The Q3PickPartsStyle_Set function sets the picking parts style value of the style object specified by the pickPartsObject parameter to the value specified in the parts parameter.


© 1997 Apple Computer, Inc.

Previous | QD3D Book | Overview | Chapter Contents | Next |